home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr49 / 134_01.zip / CTOA.NRO < prev    next >
Text File  |  1993-06-12  |  2KB  |  60 lines
  1. .so AN.NRO
  2. .TH CTOA 1 "CRL-to-CSM postprocessor"
  3. .SH NAME
  4. CTOA - CRL-to-CSM postprocessor
  5. .SH SYNOPSIS
  6. .bo
  7. ctoa infile.c [>outfile.csm]
  8. .SH DESCRIPTION
  9. .PP 
  10. CTOA is a postprocessor intended to produce the assembly
  11. language equivalent of a BDS `C' program, either so that the user
  12. can see what sort of code the compiler generated or in order
  13. (Heaven forbid!) to use it as a base to develop an assembly
  14. language version of the same function.
  15. .PP
  16. To operate, it needs the following files:
  17. .br
  18. .sp
  19. .in +4
  20. .ti -2
  21. - The original source file (normally <program>.C).
  22. .br
  23. .ti -2
  24. - The relocatable object file, <program>.CRL.
  25. .br
  26. .ti -2
  27. - (Optional) The symbol table file, <program>.CDB, produced by
  28. compiling the source with the '-k' option in BDS `C' releases
  29. 1.50 and later.  While this file is not specifically required,
  30. the postprocessor can do a much better job if it is present.  
  31. .br
  32. .in -4
  33. .PP
  34. It produces, to the standard directed output stream, an assembly
  35. language source in .CSM format, suitable for running through
  36. CASM2.  
  37. .SH EXAMPLES
  38. ctoa stdlib1.c >stdlib1.csm
  39. .SH DIAGNOSTICS
  40. .PP
  41. As each function is processed, CTOA gives statistics on the
  42. terminal relating to the function.  Any other messages are either
  43. standard I/O error messages or indicate an internal error in CTOA.
  44. .SH BUGS
  45. .PP
  46. CTOA cannot read the programmer's mind;  it may code an
  47. inappropriate symbol for some particular value in the object
  48. code.  If hand changes are made to the .CSM file prior to
  49. assembly, they must be verified *extremely* carefully, as the
  50. generated assembly code may have non-symbolic references to
  51. locations that have been changes.
  52. .SH NOTES
  53. .PP
  54. If it is impossible to include the .CDB file (for space
  55. limitations, for example), it is still wise to use an object
  56. program compiled with the '-k' option.  The postprocessor uses
  57. the line number information in the .CRL file in generating the
  58. comments in the assembly language; this information is not
  59. available for programs compiled without '-k'.
  60.